home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmbase-grok-1.2 / README < prev    next >
Text File  |  1995-06-25  |  5KB  |  104 lines
  1.  
  2. xmbase-grok - Graphical Resource Organizer Kit
  3. ----------------------------------------------
  4.  
  5. For people who don't read long READMEs, I'll describe compilation and
  6. installation first:
  7.  
  8. * if you have xmkmf:
  9.   -- edit Imakefile and change GLIB and GBIN if the program and support files
  10.      should be installed in a directory other than /usr/local/{bin,lib}.
  11.   -- run "xmkmf" to create a Makefile. You may have to edit the Makefile:
  12.      *  for Solaris 2.x, append -lgen to the LIB line
  13.      *  for some Suns, you get an error unless you indent line 312 with a Tab
  14.      *  for HP/UX, find the "yacc -d" line and append " -Nm15000" to "-d".
  15.   -- run "make"
  16.   -- run "grok" and choose a database from the Database pulldown
  17.   -- if you don't like grok, delete this directory and the ~/.grok directory
  18.   -- run "make install"
  19.   -- copy grokdir/* to ~/.grok
  20.   -- if your system is an SGI, copy Grok.icons to ~/.icons/Grok.icon
  21.  
  22. * if you don't have xmkmf:
  23.   -- change GBIN and GLIB in Makefile.alt rather than in Imakefile
  24.   -- run "make -f Makefile.alt" and choose a system from the list
  25.   -- run "make -f Makefile.alt" <sys>
  26.   -- run "grok" and decide whether you want to keep it
  27.   -- run "make -f Makefile.alt install"
  28.   -- copy grokdir/* to ~/.grok
  29.  
  30. At this time, grok is supported only on SGI, HP, SunOS, and IBM platforms.
  31. For porting to other platforms, read and edit config.h.
  32.  
  33. ---------------------------------------
  34.  
  35. xmbase-grok, formerly just called "grok", is a simple database manager
  36. and UI builder that can -
  37.  
  38.   *  keep phone and address lists (like a rolodex)
  39.   *  store phone call logs
  40.   *  keep todo lists
  41.   *  manage any other database after simple GUI-driven customization
  42.  
  43. More precisely, grok is a program for displaying and editing strings
  44. arranged in a grid of rows and columns. Each row is presented as a "card"
  45. consisting of multiple columns, or "fields", that allow data entry. The
  46. presentation of the data is programmable; a user interface builder that
  47. allows the user to arrange fields on a card graphically is part of grok.
  48. Grok also supports a simple language that allows sophisticated queries
  49. and data retrieval. Grok comes with the above examples and a few others
  50. as pre-built applications.
  51.  
  52. Grok is not a general-purpose database program. It was designed for small
  53. applications typical for desktop accessories. If you attempt to run your
  54. major airline reservation system or your space shuttle project with it,
  55. you are guaranteed to be disappointed.
  56.  
  57. The distribution contains sample applications and sample databases in the
  58. "grokdir" directory. If grok is started in a directory that contains a
  59. "grokdir" directory, the contents of that directory are presented in grok
  60. in addition to the ones from ~/.grok. This is meant to allow experimenting
  61. with grok without having to copy files to one's home directory.
  62.  
  63. The grok executable and the grok.help file should be copied to the GBIN
  64. and GLIB directory listed in the makefile used, respectively (default is
  65. /usr/local/bin and /usr/local/lib), although any other place in the search
  66. path ($PATH) will also work. Run "make install" to install grok. In
  67. addition, the distribution contains a PostScript user manual "Manual.ps"
  68. that should be copied to a safe place, or printed. The TeX sources for
  69. Manual.ps are in the doc directory.
  70.  
  71. Bug reports to thomas@bitrot.in-berlin.de. Don't forget to include the
  72. version number as printed by "grok -v". If you have new applications
  73. (forms) that would be of general interest, I'd appreciate to get a copy
  74. for inclusion in the next release. Send mail to me if you want to be put
  75. on the mailing list, grok@bitrot.in-berlin.de.
  76.  
  77. The main archive for grok is ftp.fu-berlin.de (/pub/unix/graphics).
  78. It is also available from swedishchef.lerc.nasa.gov (programs/X/) and
  79. ftp.x.org (contrib/applications/).
  80.  
  81.  
  82. Copyright:
  83.  
  84. grok is Copyrighted by Thomas Driemeyer, 1994. License to copy, publish,
  85. and distribute is granted to everyone provided that three conditions are
  86. met:
  87.  
  88. - my name and email address, "Thomas Driemeyer <thomas@bitrot.in-
  89.   berlin.de>" must remain in the distribution and any documentation
  90.   that was not part of this distribution. In particular, my name
  91.   and address must be shown in the About popup.
  92. - if you redistribute a modified version, the fact that the version
  93.   is modified must be stated in all places that my name is shown.
  94. - this copyright notice must be included in your distribution.
  95.  
  96. If these conditions are met, you can do whatever you like. The idea is
  97. that I would be pissed if someone else claimed he wrote the thing, and
  98. I don't want bugs introduced by others attributed to me. Make as much
  99. money with it as you can. Drop me a line, I am curious.
  100.  
  101. There are no implied or expressed warranties for grok. I do not claim it
  102. is good for anything whatsoever, and if you lose your precious data or
  103. your cat dies this is entirely your problem.
  104.